Developer CD Series 1995 June: Reference Library/Dev.CD Jun 95/Dev.CD Jun 95.toast/What's New?/New System Software Extensions/QuickDraw 3D ß/Programming/Interfaces/QD3DDrawContext.h

C/C++ Source or Header | 1995-04-12 | 9.6 KB | 352 lines | [TEXT/MPS ]

/******************************************************************************
 **                                                                             **
 **     Module:        QD3DDrawContext.h                                         **
 **                                                                          **
 **                                                                          **
 **     Purpose:    Draw context class types and routines                        **
 **                                                                          **
 **                                                                          **
 **                                                                          **
 **     Copyright (C) 1993-1995 Apple Computer, Inc. All rights reserved.     **
 **                                                                          **
 **                                                                          **
 *****************************************************************************/
#ifndef QD3DDrawContext_h
#define QD3DDrawContext_h

#if PRAGMA_ONCE
    #pragma once
#endif

#if defined(WINDOW_SYSTEM_MACINTOSH) && WINDOW_SYSTEM_MACINTOSH
#include <Quickdraw.h>
#include <FixMath.h>
#include <graphics types.h>
#endif /* WINDOW_SYSTEM_MACINTOSH */

#if defined(WINDOW_SYSTEM_X11) && WINDOW_SYSTEM_X11
#include <X11/Xlib.h>
#include <X11/Xutil.h>
#endif /* WINDOW_SYSTEM_X11 */

#ifdef __cplusplus
extern "C" {
#endif /*  __cplusplus  */


/******************************************************************************
 **                                                                             **
 **                            DrawContext Data Structures                         **
 **                                                                             **
 *****************************************************************************/

typedef enum TQ3DrawContextClearImageMethod{
    kQ3ClearMethodNone,
#if defined(ESCHER_VER_15) && ESCHER_VER_15
    kQ3ClearMethodWithColor,
    kQ3ClearMethodWithShader
#else
    kQ3ClearMethodWithColor
#endif /* ESCHER_VER_15 */
} TQ3DrawContextClearImageMethod;


typedef struct TQ3DrawContextData {
    TQ3DrawContextClearImageMethod    clearImageMethod;
    TQ3ColorARGB                    clearImageColor;
    TQ3Area                            pane;
    TQ3Boolean                        paneState;
    TQ3Bitmap                        mask;
    TQ3Boolean                        maskState;
    TQ3Boolean                        doubleBufferState;
} TQ3DrawContextData;


/******************************************************************************
 **                                                                             **
 **                                DrawContext Routines                         **
 **                                                                             **
 *****************************************************************************/

EXPORT TQ3ObjectType Q3DrawContext_GetType(
    TQ3DrawContextObject        drawContext);

EXPORT TQ3Status Q3DrawContext_SetData(
    TQ3DrawContextObject        context,
    const TQ3DrawContextData    *contextData);

EXPORT TQ3Status Q3DrawContext_GetData(
    TQ3DrawContextObject        context,
    TQ3DrawContextData            *contextData);

EXPORT TQ3Status Q3DrawContext_SetClearImageColor(
    TQ3DrawContextObject        context,
    const TQ3ColorARGB             *color);

EXPORT TQ3Status Q3DrawContext_GetClearImageColor(
    TQ3DrawContextObject        context,
    TQ3ColorARGB                 *color);

EXPORT TQ3Status Q3DrawContext_SetPane(
    TQ3DrawContextObject        context,
    const TQ3Area                 *pane);

EXPORT TQ3Status Q3DrawContext_GetPane(
    TQ3DrawContextObject        context,
    TQ3Area                         *pane);

EXPORT TQ3Status Q3DrawContext_SetPaneState(
    TQ3DrawContextObject        context,
    TQ3Boolean                    state);

EXPORT TQ3Status Q3DrawContext_GetPaneState(
    TQ3DrawContextObject        context,
    TQ3Boolean                    *state);

EXPORT TQ3Status Q3DrawContext_SetClearImageMethod(
    TQ3DrawContextObject            context,
    TQ3DrawContextClearImageMethod     method);

EXPORT TQ3Status Q3DrawContext_GetClearImageMethod(
    TQ3DrawContextObject            context,
    TQ3DrawContextClearImageMethod     *method);

EXPORT TQ3Status Q3DrawContext_SetMask(
    TQ3DrawContextObject        context,
    const TQ3Bitmap                *mask);

EXPORT TQ3Status Q3DrawContext_GetMask(
    TQ3DrawContextObject        context,
    TQ3Bitmap                    *mask);

EXPORT TQ3Status Q3DrawContext_SetMaskState(
    TQ3DrawContextObject        context,
    TQ3Boolean                    state);

EXPORT TQ3Status Q3DrawContext_GetMaskState(
    TQ3DrawContextObject        context,
    TQ3Boolean                    *state);

EXPORT TQ3Status Q3DrawContext_SetDoubleBufferState(
    TQ3DrawContextObject        context,
    TQ3Boolean                     state);

EXPORT TQ3Status Q3DrawContext_GetDoubleBufferState(
    TQ3DrawContextObject        context,
    TQ3Boolean                     *state);


/******************************************************************************
 **                                                                             **
 **                            Pixmap Data Structure                             **
 **                                                                             **
 *****************************************************************************/

typedef struct TQ3PixmapDrawContextData {
    TQ3DrawContextData        drawContextData;
    TQ3Pixmap                pixmap;
} TQ3PixmapDrawContextData;


/******************************************************************************
 **                                                                             **
 **                        Pixmap DrawContext Routines                             **
 **                                                                             **
 *****************************************************************************/

EXPORT TQ3DrawContextObject Q3PixmapDrawContext_New(
    const TQ3PixmapDrawContextData    *contextData);

EXPORT TQ3Status Q3PixmapDrawContext_SetPixmap(
    TQ3DrawContextObject            drawContext,
    const TQ3Pixmap                    *pixmap);

EXPORT TQ3Status Q3PixmapDrawContext_GetPixmap(
    TQ3DrawContextObject            drawContext,
    TQ3Pixmap                        *pixmap);

#if defined(WINDOW_SYSTEM_MACINTOSH) && WINDOW_SYSTEM_MACINTOSH

/******************************************************************************
 **                                                                             **
 **                        Macintosh DrawContext Data Structures                 **
 **                                                                             **
 *****************************************************************************/

typedef enum TQ3MacDrawContext2DLibrary {
    kQ3Mac2DLibraryNone,
    kQ3Mac2DLibraryQuickDraw,
    kQ3Mac2DLibraryQuickDrawGX
} TQ3MacDrawContext2DLibrary;


typedef struct TQ3MacDrawContextData {
    TQ3DrawContextData            drawContextData;
    CWindowPtr                    window;
    TQ3MacDrawContext2DLibrary    library;
    gxViewPort                    viewPort;
    CGrafPtr                    grafPort;
} TQ3MacDrawContextData;


/******************************************************************************
 **                                                                             **
 **                        Macintosh DrawContext Routines                         **
 **                                                                             **
 *****************************************************************************/

EXPORT TQ3DrawContextObject Q3MacDrawContext_New(
    const TQ3MacDrawContextData    *drawContextData);

EXPORT TQ3Status Q3MacDrawContext_SetWindow(
    TQ3DrawContextObject        drawContext,
    const CWindowPtr            window);

EXPORT TQ3Status Q3MacDrawContext_GetWindow(
    TQ3DrawContextObject        drawContext,
    CWindowPtr                    *window);

EXPORT TQ3Status Q3MacDrawContext_SetGXViewPort(
    TQ3DrawContextObject        drawContext,
    const gxViewPort            viewPort);

EXPORT TQ3Status Q3MacDrawContext_GetGXViewPort(
    TQ3DrawContextObject        drawContext,
    gxViewPort                    *viewPort);

EXPORT TQ3Status Q3MacDrawContext_SetGrafPort(
    TQ3DrawContextObject        drawContext,
    const CGrafPtr                grafPort);

EXPORT TQ3Status Q3MacDrawContext_GetGrafPort(
    TQ3DrawContextObject        drawContext,
    CGrafPtr                    *grafPort);

EXPORT TQ3Status Q3MacDrawContext_Set2DLibrary(
    TQ3DrawContextObject        drawContext,
    TQ3MacDrawContext2DLibrary    library);

EXPORT TQ3Status Q3MacDrawContext_Get2DLibrary(
    TQ3DrawContextObject        drawContext,
    TQ3MacDrawContext2DLibrary    *library);

#endif /* WINDOW_SYSTEM_MACINTOSH */

#if defined(WINDOW_SYSTEM_X11) && WINDOW_SYSTEM_X11

/******************************************************************************
 **                                                                             **
 **                                Types                                         **
 **                                                                             **
 *****************************************************************************/

typedef struct TQ3XBufferData *TQ3XBufferObject;

typedef struct TQ3XColormapData {
    long        baseEntry;
    long        maxRed;
    long        maxGreen;
    long        maxBlue;
    long        multRed;
    long        multGreen;
    long        multBlue;
} TQ3XColormapData;


typedef struct TQ3XDrawContextData {
    TQ3DrawContextData        contextData;
    Display                    *display;
    Drawable                drawable;
    Visual                    *visual;
    Colormap                cmap;
    TQ3XColormapData        *colorMapData;
} TQ3XDrawContextData;


/******************************************************************************
 **                                                                             **
 **                            XDrawContext Routines                             **
 **                                                                             **
 *****************************************************************************/

#ifdef XDC_OLD
EXPORT TQ3DrawContextObject Q3XDrawContext_New(
    void);

EXPORT void Q3XDrawContext_Set(
    TQ3DrawContextObject        drawContext,
    unsigned long            flag,
    void                    *data);

EXPORT void Q3XDrawContext_Get(
    TQ3DrawContextObject        drawContext,
    unsigned long            flag,
    void                    *data);
#endif  /* XDC_OLD */

EXPORT TQ3XBufferObject Q3XBuffers_New(
    Display                    *dpy,
    unsigned long            numBuffers,
    Window                    window);

EXPORT void Q3XBuffers_Swap(
    Display                    *dpy,
    TQ3XBufferObject            buffers);

EXPORT XVisualInfo *Q3X_GetVisualInfo(
    Display                    *dpy,
    Screen                    *screen);


EXPORT TQ3DrawContextObject Q3XDrawContext_New(
    const TQ3XDrawContextData    *xContextData);

EXPORT TQ3Status Q3XDrawContext_SetDisplay(
    TQ3DrawContextObject        drawContext,
    const Display                *display);

EXPORT TQ3Status Q3XDrawContext_GetDisplay(
    TQ3DrawContextObject        drawContext,
    Display                        **display);

EXPORT TQ3Status Q3XDrawContext_SetDrawable(
    TQ3DrawContextObject        drawContext,
    Drawable                    drawable);

EXPORT TQ3Status Q3XDrawContext_GetDrawable(
    TQ3DrawContextObject        drawContext,
    Drawable                    *drawable);

EXPORT TQ3Status Q3XDrawContext_SetVisual(
    TQ3DrawContextObject        drawContext,
    const Visual                *visual);

EXPORT TQ3Status Q3XDrawContext_GetVisual(
    TQ3DrawContextObject        drawContext,
    Visual                        **visual);

EXPORT TQ3Status Q3XDrawContext_SetColormap(
    TQ3DrawContextObject        drawContext,
    Colormap                    colormap);

EXPORT TQ3Status Q3XDrawContext_GetColormap(
    TQ3DrawContextObject        drawContext,
    Colormap                    *colormap);

EXPORT TQ3Status Q3XDrawContext_SetColormapData(
    TQ3DrawContextObject        drawContext,
    const TQ3XColormapData        *colormapData);

EXPORT TQ3Status Q3XDrawContext_GetColormapData(
    TQ3DrawContextObject        drawContext,
    TQ3XColormapData            *colormapData);

#endif /* WINDOW_SYSTEM_X11 */


#ifdef __cplusplus
}
#endif /*  __cplusplus  */

#endif  /*  QD3DDrawContext_h  */